home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / source / thesource6.dms / thesource6.adf / Source / Compression / hcompress.lha / hcompress / unix / aareadme next >
Encoding:
Text File  |  1992-04-22  |  2.2 KB  |  43 lines
  1.         Installation instructions for HCOMPRESS on Unix machines
  2.                     R. L. White, 20 April 1992
  3.  
  4. This directory contains a makefile for building HCOMPRESS on a Unix
  5. machine and some C-shell scripts to make using the programs a little
  6. easier.  This makefile has only been tested on Suns and DECStations, so
  7. some small modifications may be required for other machines.
  8.  
  9. Steps for installation:
  10.  
  11. (1) Copy the contents the contents of this directory into the
  12.     source directory.
  13. (2) Do "make all" (or just "make") to compile and link the programs.
  14. (3) Edit makefile: change the INSTALLDIR variable to point to the
  15.     directory where you want the executables to reside.  By default
  16.     they will go into ${HOME}/bin, i.e. your bin directory.  You should
  17.     chose a directory that is included in your path.
  18. (4) Do "make install" to install the programs in your chosen directory.
  19. (5) Do "rehash" to update your hash tables.
  20. (6) There is a man page in the file hcompress.1.  It can be installed
  21.     in your man directory.  The doc directory includes both a plain text
  22.     version of the man page (hcompress.txt) and a postscript version
  23.     (hcompress.ps).
  24.  
  25. Now the programs should be ready to run.  You may want to customize
  26. the shell scripts for your applications.  Some possible changes to
  27. consider:
  28.  
  29. (1) There are shell scripts to compress multiple files in FITS format
  30.     and in hhh/hhd format.  If you usually use some other formats you
  31.     could include in the script a conversion from your format to
  32.     one of the accepted formats.
  33. (2) The amount of compression is determined by the scale factor, set by
  34.     the -s option in the programs.  For astronomical images the compression
  35.     is generally limited by the amount of noise in the images and the
  36.     scale factor should be about 2 times the RMS noise in the image.
  37.     For noiseless images any non-zero scale factor will give up some
  38.     information, so the choice of scale factor will be determined by how
  39.     much you are willing to lose.  A default scale factor of 666 is used
  40.     in the scripts -- this should probably be changed to a value appropriate
  41.     for your typical images.  If you like, you could set this default to 0
  42.     (lossless compression.)
  43.